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Claims 



What is claimed is: 

[cl] A method of testing an embedded example, comprising: 
extracting the embedded example from documentation; 
creating a test suite from the embedded example; 
selecting a tool against which to execute the test suite; 
executing the test suite against the tool to generate an output response; and 
comparing the output response of the tool to a golden file. 

[c2] The method of claim 1, further comprising: 

creating the embedded example using at least one tag chosen from a tag set. 

[c3] The method of claim 1 , further comprising: 

creating the golden file using at least one tag chosen from a tag set. 

[c4] The method of claim 1, further comprising: 

locating a source of error if the output response of the tool varies from the golden 



[c5] The method of claim 1, further comprising: 

correcting the embedded example if the output response of the tool varies from the 



file. 



golden file. 



[c6] 



The method of claim 1, further comprising: 
sending a comparison result to a display device. 



[c7] 



The method of claim 1, further comprising: 
storing a comparison result onto a storage device. 
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[c8] The method of claim 1, wherein the test suite is created by interpreting a tag set. 

[c9] The method of claim 1, wherein the tool is a command line tool. 

[clO] The method of claim 1, wherein the golden file comprises a proper output 
response of the tool executing the test suite. 

[ell] The method of claim 10, wherein the golden file is created manually. 

[cl2] A method of testing an embedded example, comprising: 
extracting the embedded example from documentation; 
creating a test suite from the embedded example; 
selecting a tool against which to execute the test suite; 
executing the test suite against the tool to generate an output response; 
comparing the output response of the tool to a golden file; 
creating the embedded example using at least one tag chosen from a tag set; 
creating the golden file using at least one tag chosen from a tag set; 
locating a source of error if the output response of the tool varies from the golden 
file; 

correcting the embedded example if the output response of the tool varies from the 
golden file; 

sending a comparison result to a display device; and 
storing a comparison result onto a storage device. 

[cl3] A method of embedding tags, comprising: 

locating an embedded example in documentation; and 

delineating the embedded example with a start tag and a closing tag chosen from a 
tag set. 

[cl4] The method of claim 1 3 , further comprising : 

embedding a control statement as part of the embedded example. 

18 



PATENT APPLICATION 
ATTORNEY DOCKET NO. 16159/029001; P6714 



[cl5] The method of claim 1 3, further comprising: 

embedding a file location statement as part of the embedded example. 

[cl6] A method of embedding tags, comprising: 

locating an embedded example in documentation; 

delineating the embedded example with a start tag and a closing tag chosen from a 
tag set; 

embedding a control statement as part of the embedded example; and 
embedding a file location statement as part of the embedded example. 

[cl7] A method of creating a test suite, comprising: 
examining an extracted example; 

interpreting a tag located within the extracted example; and 
aggregating constituent parts using the interpretation of the tag. 

[cl8] The method of claim 17, wherein the extracted example is an embedded example 
copied from documentation. 

[cl9] The method of claim 17, wherein the tag is interpreted using a defined tag set. 

[c20] The method of claim 17, wherein the constituent parts are derived from the 
extracted example and a source file. 

[c21] A computer system to test an embedded example, comprising: 
a processor; 
a memory; 
a storage device; 
a computer display; and 

software instructions stored in the memory for enabling the computer system 
under control of the processor, to perform: 
extracting the embedded example from documentation; 
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creating a test suite from the embedded example; 

selecting a tool against which to execute the test suite; 

executing the test suite against the tool to generate an output response; and 

comparing the output response of the tool to a golden file. 

[c22] The computer system of claim 21, further comprising: 

software instructions for creating the embedded example using at least one tag 
chosen from a tag set. 

[c23] The computer system of claim 2 1 , further comprising: 

software instructions for creating the golden file using at least one tag chosen from 
a tag set. 

[c24] The computer system of claim 21 , further comprising: 

software instructions for locating a source of error if the output response of the 
tool varies from the golden file. 

[c25] The computer system of claim 21 , further comprising: 

software instructions for correcting the embedded example if the output response 
of the tool varies from the golden file. 

[c26] The computer system of claim 2 1 , further comprising: 

software instructions for sending a comparison result to a display device. 

[c27] The computer system of claim 2 1 , further comprising: 

software instructions for storing a comparison result onto a storage device. 

[c281 The computer system of claim 21, wherein the golden file comprises a proper 
output response of the tool executing the test suite. 

[c29] The computer system of claim 21 , wherein the golden file is created manually. 
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[c30] A computer system to test an embedded example, comprising: 
a processor; 
a memory; 
a storage device; 
a computer display; and 

software instructions stored in the memory for enabling the computer system 
under control of the processor, to perform: 
extracting the embedded example from documentation; 
creating a test suite from the embedded example; 
selecting a tool against which to execute the test suite; 
executing the test suite against the tool to generate an output response; 
comparing the output response of the tool to a golden file; 
creating the embedded example using at least one tag chosen from a tag set; 
creating the golden file using at least one tag chosen from a tag set; 
locating a source of error if the output response of the tool varies from the 
golden file; 

correcting the embedded example if the output response of the tool varies 

from the golden file; 
sending a comparison result to a display device; and 
storing a comparison result onto a storage device. 

[c31] An apparatus for testing an embedded example, comprising: 

means for extracting the embedded example from documentation; 
means for creating a test suite from the embedded example; 
means for selecting a tool against which to execute the test suite; 
means for executing the test suite against the tool to generate an output response; 
and 

means for comparing the output response of the tool to a golden file. 
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